大家好，我是 NextCandle 的開發者。上一篇分享了相似 K 線與歷史後續走勢的比較介面。這篇想談一個具體的資料呈現問題：畫面上的「案例數」，究竟在數什麼？

一、同一個數字，可能被讀成不同的意思

使用者看到「3 個案例」，可能以為是整個歷史資料庫只出現過 3 次，也可能把它當成統計的分母。但在這個工具裡，先要分清楚三件事：請求幾個案例、這次回傳幾個案例，以及指定後續觀測下有幾個案例可以納入比較。

NextCandle 找的是本次查詢回傳的相似案例。它們之後實際發生的價格變動，可以讓人檢查相似形態後有哪些不同結果。這個集合並不等於整個歷史資料庫的出現頻率，相似度也不是未來交易的勝率。

二、把資料完整性和方向統計一起核對

以下是用來說明資料設計的簡化例子，不是某次查詢的實測數字，也不是實際 API 欄位：

請求案例數：3
回傳案例數：3
可用後續觀測：2
其中上漲案例：1

這時「1／2」的分母是可用觀測。若只寫「上漲 50%」，讀者很容易失去這個範圍。我的做法是把上漲案例數和有效觀測數放在一起，讓人先知道這個數字建立在多少筆可用資料上。

在目前的資料處理中，有效觀測數以方向分類中實際納入的案例數核對，並檢查它是否為非負整數、是否超過回傳案例數。資訊缺少或互相矛盾時，保留未確認狀態，不把它補成 0。0 代表確認過沒有；未確認代表目前無法判定，這兩種狀態會帶來不同的解讀。

歷史路徑也需要先檢查 K 線價格、時間順序與後續資料。缺少可用後續資料的案例，可以有形態上的比較價值，但不能因此補畫一條已發生的後續走勢。

三、介面的順序也是產品選擇

我希望使用者能把相似形態、案例日期、可用資料與不同後續結果連在一起看。這些材料能幫助人思考可能的下一步，而每一個數字的適用範圍都應該能回頭核對。

目前也會提供取得到的當時新聞，讓人閱讀日期、來源與原文，自行判斷背景。每日報告已把發布時點的新聞與歷史案例整理成市場背景和情境分析。在模式比較介面中，自動比較現在與過去的背景差異並整理方向性情境，是仍在考慮的方向，尚未提供。

接下來想持續改善的是這些證據的可讀性。這篇是在討論設計原則，沒有宣布新的介面功能已上線。對做過資料介面的邦友，我想請教：案例日期、回傳案例數、有效觀測數，哪一個應該先出現在比較圖旁邊，才比較不容易被誤讀？

實際介面目前使用 React、TypeScript 與 TanStack Query。中文介面顯示簡體，本文以繁體說明。歷史觀測不保證未來結果，也不構成買賣建議。

上一篇的專案介紹
實際比較介面